Inside Macintosh: QuickDraw GX Printing Extensions and Drivers /

Chapter 4 - Printing Messages / Printing Messages Reference

Printing Messages / Device Communications Messages

GXCloseConnection

QuickDraw GX sends the GXCloseConnection message when all of the data for a print job has been sent to the device. You can override the GXCloseConnection message to perform actions your printing extension or printer driver requires at the completion of a job. Your override of the GXCloseConnection message must match the following formal declaration:

OSErr MyCloseConnection (void);

function result

An error code. The value noErr indicates that the operation was successful.

DESCRIPTION

The default implementation of the GXImageJob message sends the GXCloseConnection message at the end of sending to a device all of the data of a print job.

The default implementation of the GXCloseConnection message closes the connection to a printer. It handles PAP, serial, and not-connected connections. You can override this message to close a connection with a specific device, such as a sheetfeeder.

SPECIAL CONSIDERATIONS

You never send the GXCloseConnection message yourself.

If you are implementing a nonsupported type of communications connection, you need to perform a total override of the GXCloseConnection message. Otherwise, you need to perform your tasks and then forward the message.

RESULT CODES

gxSegmentLoadFailedErr	A required code segment could not be found, or there was not enough memory to load it.
gxPrUserAbortErr	The user has canceled printing.

The default implementation of the GXCloseConnection message can also return the communications errors that are listed in Table 4-2 on page 4-42.

SEE ALSO

The GXImageJob message is described on page 4-90.

Main | Page One | What's New | Apple Computer, Inc. | Find It | Contact Us | Help